home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / ssrun.z / ssrun
Text File  |  1998-10-30  |  7KB  |  198 lines
  1.  
  2.  
  3.  
  4. SSSSSSSSRRRRUUUUNNNN((((1111))))                                                              SSSSSSSSRRRRUUUUNNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssrun - set up and run a process to collect SpeedShop performance data
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssssssrrrruuuunnnn [options] command [args]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_s_r_u_n is used by the SpeedShop performance tools to establish the
  16.      environment to capture performance data for an executable, and create a
  17.      process from the executable (or an instrumented version), and then run
  18.      it.  When performance data is collected, it is written to a file whose
  19.      name is of the form <command>.<exptype>.<code><pid> where <code> can be
  20.      'm' for the master process created by _s_s_r_u_n, 'p' for a process created by
  21.      a call to _s_p_r_o_c(), 'f' for a process created by a call to _f_o_r_k(), 'e' for
  22.      a process created by a call to _e_x_e_c(), 's' for a system call process and
  23.      'fe' for a process created by a call to _f_o_r_k() and _e_x_e_c() with
  24.      environment variable _SPEEDSHOP_TRACE_FORK_TO_EXEC being set to False.
  25.      Data may be examined using prof(1).
  26.  
  27.      The following options may be given:
  28.  
  29.      - <_e_x_p_t_y_p_e> | -_e_x_p <_e_x_p_t_y_p_e>
  30.           Specifies the type of SpeedShop experiment to run.  The value of
  31.           <_e_x_p_t_y_p_e> specifies the particular performance data that will be
  32.           recorded during the run.  See the speedshop(1) man page for the list
  33.           of supported experiments.  Some experiments require that the target
  34.           process be instrumented to collect data; if necessary,
  35.           instrumentation (by pixie(1)) will be performed, and the resultant
  36.           instrumented executable run.  The experiment type may also be set by
  37.           setting the environment variable _SPEEDSHOP_EXPERIMENT_TYPE.  If
  38.           both are set, and they are different, a warning message will be
  39.           printed, and the command line argument will prevail.
  40.           Each experiment type corresponds to a set of "marching orders" that
  41.           the runtime will use.  This facility is provided to allow users to
  42.           specify customized experiments, and will be more fully documented in
  43.           subsequent releases.  Marching orders may also be set by setting the
  44.           environment variable _SPEEDSHOP_MARCHING_ORDERS, or by providing a
  45.           _m_o argument to ssssssssrrrruuuunnnn.  If a known experiment is specified, and the
  46.           marching orders are also specified, and they are different, a
  47.           warning will be printed, and the marching orders will prevail.  If
  48.           the experiment is not known, its name will be used and no warning
  49.           issued; if no experiment name was specified, the experiment name
  50.           will be set to "marching-orders".
  51.  
  52.      -_m_o _m_a_r_c_h_i_n_g-_o_r_d_e_r_s
  53.           Specifies marching orders; if this option is used, the environment
  54.           variable _SPEEDSHOP_MARCHING_ORDERS will not be examined.
  55.  
  56.      -_p_u_r_i_f_y
  57.           Specifies (if the independent Purify product is installed), that
  58.           purify should be run on the target, and the resulting purify'd
  59.           executable run.  Note that -_p_u_r_i_f_y and SpeedShop performance
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. SSSSSSSSRRRRUUUUNNNN((((1111))))                                                              SSSSSSSSRRRRUUUUNNNN((((1111))))
  70.  
  71.  
  72.  
  73.           experiments can not be combined.
  74.  
  75.      -_v | -_v_e_r_b_o_s_e
  76.           Specifies that a log of the operation of _s_s_r_u_n should be printed to
  77.           stderr.  The same behavior occurs if the environment variable
  78.           _SPEEDSHOP_VERBOSE is set a to a zero-length string.
  79.  
  80.      -_V   Specifies that a detailed log of the operation of _s_s_r_u_n should be
  81.           printed to stderr.  The same behavior occurs if the environment
  82.           variable _SPEEDSHOP_VERBOSE is set a to a non-zero-length string.
  83.           In this case, a non-zero-length _SPEEDSHOP_VERBOSE environment
  84.           variable will be set, so that the target and any descendant
  85.           processes will see it.
  86.  
  87.      -_w_o_r_k_s_h_o_p
  88.           Forces special instrumentation so that the experiment files can be
  89.           read by WorkShop's cvperf analyzer unless one of the capture modules
  90.           of the experiment also requires instrumentation.
  91.  
  92.      -_q_u_i_e_t
  93.           Suppresses all output other than error messages.  If set,
  94.           _SPEEDSHOP_SILENT will be set, so that the target and any descendant
  95.           processes will see it.
  96.  
  97.      -_h_a_n_g
  98.           Specifies that the process should be left waiting just before
  99.           executing its first instruction.
  100.  
  101.      -_p_o_r_t _h_o_s_t_n_a_m_e _p_o_r_t_n_o
  102.           Specifies that the process is to be left waiting, and, in addition,
  103.           notifications of status be sent to the socket on the host given by
  104.           _h_o_s_t_n_a_m_e and port given by _p_o_r_t_n_o from the command line.  When the
  105.           process is ready, a message of the form "running <pid> <host>" will
  106.           be sent to inform the requestor of the target process' PID, and
  107.           (possibly remote) host.  A debugger may then attach to it and take
  108.           control of its execution.
  109.  
  110.      -_x   Specifies that the process is to be left waiting, and, in addition,
  111.           that the window of the WorkShop Debugger requesting the creation (as
  112.           given by the _d_i_s_p_l_a_y-_i_d and _w_i_n_d_o_w-_i_d on the command line) be
  113.           informed of the target process' PID.  A debugger may then attach to
  114.           it and take control of its execution.
  115.  
  116.      -_n_a_m_e _t_a_r_g_e_t-_n_a_m_e
  117.           Specifies that the target, instrumented or not, should be run with
  118.           argv[0] set to _t_a_r_g_e_t-_n_a_m_e.  Normally, both instrumented and
  119.           uninstrumented executables are run with argv[0] set to the original
  120.           name.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. SSSSSSSSRRRRUUUUNNNN((((1111))))                                                              SSSSSSSSRRRRUUUUNNNN((((1111))))
  136.  
  137.  
  138.  
  139. SEE ALSO
  140.      speedshop(1), ssdump(1), prof(1), pixie(1), malloc_ss(3), fpe_ss(3),
  141.      io_ss(3), cvperf(1)
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.